home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / ham / msys114.zip / HAPNMSYS.COM / HAPNDRSI.DOC < prev    next >
Text File  |  1991-02-25  |  6KB  |  124 lines
  1.  
  2. HAPNDRSI Device Driver for the DRSI PC-Packet Adapter
  3.  
  4. by Jack Botner, VE3LNY             February 17, 1991
  5.  
  6. (C) Copyright HAPN Hamilton and Area Packet Network 1990, 1991
  7.  
  8. Jack Botner                        H. A. P. N.
  9. 222 Divadale Drive                 Box 4466, Station D
  10. Toronto, Ontario                   Hamilton, Ontario
  11. Canada   M4G 2P7                   Canada   L8V 4S7
  12.  
  13. Compuserve: 73327,176 (private mail only, please)
  14.  
  15.  
  16.  
  17.    Introduction
  18.    ────────────
  19.  
  20. This device driver allows the DRSI PC-Packet Adapter to operate with
  21. the HAPN-1 software. The software developed to support the HAPN-1
  22. adapter is very user-friendly and provides a high level of function.
  23. In the HAPN implementation, all Level-1 (hardware) support functions
  24. are done by the DOS device driver, making it possible to support
  25. different adapters by changing only the device driver. Higher-level
  26. functions (AX.25, KISS, etc.) are provided by separate modules that
  27. are independent of the hardware being used.
  28.  
  29. This driver is installed as a DOS device driver by placing an entry in
  30. CONFIG.SYS. It takes over all the hardware functions related to the
  31. adapter and provides an application program interface for accessing
  32. the packet queues and other adapter functions.
  33.  
  34. To use this device driver with MSYS, a module named HAPNKISS.COM is
  35. required to provide the KISS interface between MSYS and the device
  36. driver. Alternatively, the HAPN AX.25 Program Library (available from
  37. HAPN) may be used to provide the usual AX.25 communications support.
  38.  
  39.  
  40.    Installing HAPNDRSI.SYS
  41.    ───────────────────────
  42.  
  43. HAPNDRSI.SYS is installed by placing a device entry in your boot disk
  44. CONFIG.SYS file. For floppy disk only systems, a copy of HAPNDRSI.SYS must
  45. be placed on the boot diskette. The CONFIG.SYS entry appears as follows.
  46. All command line parameters appear within square brackets, which means
  47. that they are optional. The default values are satisfactory for most
  48. installations. If the parameters are coded, they must not contain any
  49. blanks between the parameters.
  50.  
  51.     device=[d:\path\]hapndrsi.sys [base=bbb][,irq=i][,ttsiz=z][,cts0=xx]
  52.                                   [,duplex0=yyy][,cts1=xx][,duplex1=yyy]
  53.                                   [,rxbuffers=rr][,txbuffers=tt]
  54.                                   [,baud0=nnnn][,baud1=nnnn][,pri=n]
  55.                                   [,tim=alt]
  56.  
  57. where bbb is the adapter 8530 base address (in hex). The default
  58.           value is 300. This value must match the setting of sw1-1.
  59.         i is the IRQ (interrupt) level. Values may be 0 through 7, and
  60.           the default value is 2. This value must match the setting
  61.           of sw1-3 through 8.
  62.        rr is the number of Rx buffers to allocate. Minimum
  63.           number is 5, maximum number is 25, default number is 10.
  64.        tt is the number of Tx buffers to allocate. Minimum
  65.           number is 5, maximum number is 30, default number is 15.
  66.        xx is the clear-to-send delay for each port in timer ticks (55 ms).
  67.           Values are 0 to 99, with default value 0.
  68.       yyy is hdx or fdx (only 1st letter scanned). Default is hdx.
  69.         z is the size of the trace table in kbytes. May be between
  70.           1 and 9. The default value is 4. Set it smaller to conserve
  71.           memory and larger to do datastream debugging.
  72.      nnnn to specify the baud rate when the driver is used with an
  73.           application that is unable to set up the baudrate. The
  74.           default value is 1200.
  75.     pri=n (priority=no) By default the driver will change the priority
  76.           on the PC's interrupt controller so that the adapter interrupt
  77.           has the highest priority. This parameter tells the driver to
  78.           leave the interrupt controller priority setting alone. Use
  79.           this parameter when you have more than one adapter installed,
  80.           to help you manage the interrupt priorities. If the adapter
  81.           interrupt priority is not high enough, you will get numerous
  82.           interrupt overruns and underruns.
  83.   tim=alt tells the driver to use int 1c (hex) for the timer tick
  84.           interrupt instead of int 8. Int 8 is generally more reliable
  85.           when programs are run that use the timer tick interrupt but
  86.           do not share it properly; however in some cases it may be
  87.           desired to use int 1c instead.
  88.  
  89. In its default configuration, HAPNDRSI.SYS uses 25K of memory. The amount
  90. of memory depends on the number of Rx and Tx buffers allocated, and the
  91. size of the trace table. For example, if you specify 8 Rx and 10 Tx
  92. buffers, and a 1K trace table, 20K of memory will be taken. If you're
  93. short of memory try using the minimum buffers but performance may suffer
  94. badly at high packet volumes.
  95.  
  96. Example of CONFIG.SYS entry with no command line parameters:
  97.  
  98.     device=hapndrsi.sys
  99.  
  100.   or
  101.  
  102.     device=c:\msys\hapndrsi.sys
  103.  
  104. Example of CONFIG.SYS entry with command line parameters to minimize
  105. memory requirements and use different irq interrupt:
  106.  
  107.     device=hapndrsi.sys irq=7,rxbuf=5,txbuf=5,ttsiz=1
  108.  
  109.  
  110.    Notes
  111.    ─────
  112.  
  113. This driver supports two DRSI adapters by loading two copies of the
  114. driver, and setting the parameters accordingly. Hoewever it does not
  115. support interrupt sharing between adapters. This may be provided in
  116. a future release. For now, try to use another interrupt for the second
  117. adapter. Good candidates are IRQ2, 5, and 7.
  118.  
  119. If you have a problem with this software, try to describe the
  120. environment and symptoms as thoroughly as possible and let me know
  121. about it. I'll try to fix it if I can. Send a message by Compuserve
  122. to the address above, or VE3LNY@VE3NUU.
  123.  
  124.